home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / business / dates611.zip / DATES.DOC < prev    next >
Text File  |  1996-11-30  |  28KB  |  632 lines
  1. DATES.DOC                            1                         Revised: 11-30-96
  2.  
  3. This program keeps track  of  birthdays,  anniversaries,  upcoming  events,  etc
  4. giving you advance warning so you can send out cards, leave town, etc.  Features
  5. of this program:
  6.  
  7.   * Initially defaults to showing all events happening within 14 days.
  8.   * You can set up multiple date files, each with their own day threshold;
  9.     for example, one file for birthdays, another for business meetings, etc.
  10.   * You can establish a different threshold on an event-by-event basis if
  11.     desired.
  12.   * This program can be included in your AUTOEXEC.BAT file to provide notices
  13.     every time you turn on your PC.
  14.   * You can specify dates like the "last Thursday" or the "first Monday" of
  15.     a given month.
  16.   * Month-long dates can be entered (e.g. "10/XX/XX Customer Service Month").
  17.   * Recurring dates that happen each month on the same date (e.g. "XX/14/XX
  18.     Mortgage due") can be used.
  19.   * Weekly reminders for events that happen the same weekday every week can
  20.     be used.
  21.   * Dates can be in the United States format (/DATE=mm/dd/yy) or in most other
  22.     formats (e.g. /DATE=dd-mm-yy).
  23.   * The output date format does not have to correspond to the input date format.
  24.   * Months can be entered as sequential months (1 for January, 2 for February,
  25.     etc) or else entered as the months themselves (JAN, FEB, etc).
  26.   * Dates don't have to be padded (9/6/94, 09/06/94, and SEP/06/1994 are all
  27.     accepted).
  28.   * Dates in the future can be processed or ignored at your preference.
  29.   * The program will show you the weekday, age, and/or days until the event
  30.     if desired.
  31.   * Comment lines can be displayed if desired (e.g. "Events relating to work:").
  32.   * The program can automatically pause when done or after a set number of
  33.     lines if desired.
  34.   * Entries can be sorted before display based on their "date difference" (the
  35.     number of days before the event occurs) or in their original order.
  36.   * Decimal codes (like CR/LF) can be embedded in the display file if desired,
  37.     allowing you to change colors with in the display line or split the line
  38.     into several lines for display.
  39.  
  40. The dates input file:
  41.  
  42.   The dates file is a simple ASCII text file, created and maintained with any
  43.   text editor.  Each record should begin with a date (typically in mm/dd/yy
  44.   format) followed by a description of the event.  For example:
  45.  
  46.         05/05/93 Lucy Baines
  47.  
  48.   Blank lines or any line which begins with a colon (":") or semi-colon (";")
  49.   are ignored by the program.  Lines which begin with an asterisk ("*") are
  50.   printed verbatim (minus the asterisk); add spacing after the asterisk if you
  51.   want the lines to be indented upon display.  Note:  Comments will be ignored
  52.   if /SORT is specified.
  53.  
  54.  
  55. DATES.DOC                            2                         Revised: 11-30-96
  56.  
  57. The format for the date:
  58.  
  59.   Note that the format for the dates shown in the input file is not necessarily
  60.   the same as the format shown on display.  See the /ODATE=format parameter for
  61.   output formats.
  62.  
  63.   For the date portion of the record, you have some flexibility.  By default,
  64.   the program expects dates to be in a mm/dd/yy format.  So August 5, 1993 is
  65.   "08/05/93".  Even with the "mm/dd/yy" format, however, four-digit years can
  66.   be entered if desired (e.g. "06/05/2005").
  67.  
  68.   You can change the sequence of the numbers by using the "/DATE=format" option.
  69.   For example, you can specify "/DATE=dd-mm-yy" if you want.  The format must
  70.   consist of the characters "DD", "MM, "YY", and one delimiter character.  The
  71.   "DD", "MM", and "YY" characters can be in either uppercase or lowercase
  72.   letters.
  73.  
  74.   The date delimiter has to be one of the following characters:
  75.      -  (dash)
  76.      /  (slash)
  77.      .  (period)
  78.  
  79.   Examples of /DATE=format specifications might be any of the following:
  80.      /DATE=mm/dd/yy      (which is the default)
  81.      /DATE=dd.mm.yy
  82.      /DATE=mm-dd-yy
  83.  
  84.   The routine parses the date field based on the delimiters and accept fields
  85.   with or without padding, years with or without the century, and alphabetic
  86.   months instead of just numeric ones.  For example, using /DATE=dd.mm.yy, all
  87.   of the following September 5, 1994 events are the same:
  88.  
  89.         05.09.94 Big event
  90.         5.9.94 Same event
  91.         5.sep.1994 Still the same thing
  92.         05.september.1994 And yet again the same event
  93.  
  94. Relative weekdays:
  95.  
  96.   If you want, you can specify a day of the month based on a relative weekday
  97.   within the month.  For example, in the United States, Thanksgiving falls on
  98.   the last Thursday in November and Father's Day is the third Sunday in June.
  99.  
  100.   If it's a relative weekday from the beginning of the month, DATES allows you
  101.   to enter these in the "day" field by using "nww" where "n" indicates the
  102.   sequence of the weekday (if you leave it off, it's presumed to be the first)
  103.   and "ww" is the first two letters of the day.  If it's a relative weekday from
  104.   the end of the month, use "Lnww" ("n" defaults to 1).
  105.  
  106.   The weekdays themselves are entered as "SU", "MO", "TU", "WE", "TH", "FR",
  107.   and "SA".
  108.  
  109.   So, for these two examples, they can be entered in your file as:
  110.  
  111.         11/LTH/XX Thanksgiving
  112.         06/3SU/XX Father's Day
  113.  
  114.  
  115. DATES.DOC                            3                         Revised: 11-30-96
  116.  
  117. Weekly reminders:
  118.  
  119.   The program can be used to display weekly reminders, which happen the same
  120.   day every week.  This is entered like this:
  121.  
  122.         xx/FR/xx It's Friday!
  123.  
  124.   In this case, the program will show you the first instance of the event no
  125.   matter what your /Ddays parameter is.  If you want the event to be shown
  126.   multiple times based on your /Ddays parameter, enter 5 relative weekday
  127.   requests instead:
  128.  
  129.         xx/1FR/xx It's Friday (showing in advance)
  130.         xx/2FR/xx It's Friday (showing in advance)
  131.         xx/3FR/xx It's Friday (showing in advance)
  132.         xx/4FR/xx It's Friday (showing in advance)
  133.         xx/5FR/xx It's Friday (showing in advance)
  134.  
  135. Dummy month, day, year parameters:
  136.  
  137.   The month, day, and year portions can be "xx" if desired.  (Obviously, they
  138.   can't be all provided as such.)
  139.  
  140.   If a day is "xx", you will be given the notice for the entire month and for 15
  141.   days before the start of the month.  For dates which vary from year to year
  142.   and which can't be done using something like "LTH" or "2MO" (primarily Easter)
  143.   you can either use the "xx" option for the day or revise the file every year.
  144.  
  145.   If a month is "XX", the date is presumed to recur each month.  For example,
  146.   "XX/10/XX Mortgage due" or "XX/3TH/XX Monthly Alanon meeting".
  147.  
  148. Which dates will show up (the /Ddays parameter):
  149.  
  150.   There's a default age threshold which determines what entries in your dates
  151.   file(s) will show up.  (Using multiple dates files--each with their own date
  152.   threshhold--is documented below.) By default, any event coming due in the next
  153.   14 days will show up when the program is run.
  154.  
  155.   Dates with explicitly coded years which are in the future will, by default,
  156.   not show up.  If you'd like to add the next five years of specific dates for
  157.   the family reunion in Hoboken, you can do so and only the next one will
  158.   potentially show up.  This can be overridden using the "/-FUTURE" parameter.
  159.  
  160.   Additionally, you can specify age thresholds on an event-by-event basis by
  161.   beginning the relevant descriptions with "/Ddays" (e.g.  "11/01/95 /D60 BIG
  162.   meeting!").  Specific age thresholds like this are not overridden by the
  163.   "/Ddays" parameter specified from the command line.  There are other
  164.   parameters which can be imbedded in the input file; see the "Other
  165.   event-by-event parameters" section below.
  166.  
  167.  
  168. DATES.DOC                            4                         Revised: 11-30-96
  169.  
  170. How the dates are actually displayed:
  171.  
  172.   As far as the actual display of the information is concerned, each event is
  173.   typically presented as just "date event", where any relative day references
  174.   like "4TH" get resolved before the date is shown.  For example, presume it's
  175.   May 25 in 1994, /D14 is in effect, and your input file has the following three
  176.   lines:
  177.  
  178.         05/28/30 Mr.Fury
  179.         05/LMO/xx Memorial Day
  180.         05/31/57 Bruce Guthrie
  181.  
  182.   The initial display settings are /DATE /-DAY /-AGE /-CTDOWN.  This presents
  183.   the information as:
  184.  
  185.         05/28/30 Mr.Fury
  186.         05/30/xx Memorial Day
  187.         05/31/57 Bruce Guthrie
  188.  
  189.   See the syntax descriptions for what each of these settings mean.  Changing
  190.   the settings to /-DATE /DAY /AGE /CTDOWN presents it as:
  191.  
  192.         [Sat] (64th) 3 days until Mr.Fury
  193.         [Mon] 5 days until Memorial Day
  194.         [Tue] (37th) 6 days until Bruce Guthrie
  195.  
  196.   In addition, DATES.EXE allows the dates that are displayed to be in a totally
  197.   different format than those in the input file.  By default, the output date
  198.   format is identical to the input date format but it does not have to be.  It
  199.   can be overridden using the /ODATE=format parameter.
  200.  
  201.   The characters that can be used in the output format include the following
  202.   special characters (from the VB/DOS on-line help):
  203.  
  204.          Symbol Description
  205.          ══════   ══════════════════════════════════════════════════════════
  206.          d        Display the day as a number without leading zeros (1-31)
  207.          dd       Display the day as a number with leading zeros (01-31)
  208.          ddd      Display the day as an abbreviation (Sun-Sat)
  209.          dddd     Display the day as a full name (Sunday-Saturday)
  210.          ddddd    Display a serial date number as a complete date
  211.                   (including day, month, and year)
  212.  
  213.          m        Display the month as a number without leading zeros (1-12);
  214.                   if used immediately following h or hh, the minute rather
  215.                   than the month is displayed
  216.          mm       Display the month as a number with leading zeros (01-12);
  217.                   if used immediately following h or hh, the minute rather
  218.                   than the month is displayed
  219.          mmm      Display the month as an abbreviation (Jan-Dec)
  220.          mmmm     Display the month as a full name (January-December)
  221.  
  222.          yy       Display the year as a two-digit number (00-99)
  223.          yyyy     Display the year as a four-digit number (1900-2040)
  224.  
  225.  
  226. DATES.DOC                            5                         Revised: 11-30-96
  227.  
  228.   You can imbed other characters in the format string as well.  If you need a
  229.   space character, use an underscore character instead.  For example, if today
  230.   is September 12, 1996, the following /ODATE=format specifications yield the
  231.   following results:
  232.  
  233.      mm/dd/yy        09/12/96
  234.      mmm_dd,_yyyy    Sep 12, 1996
  235.  
  236.   You can add the weekday to the output either using the /DAY parameter or
  237.   by specifying the /ODATE=format to be something like:
  238.  
  239.      mm/dd/yy [ddd]
  240.  
  241.   The program does not actually verify your /ODATE=format specification and
  242.   you may get a run-time error if you specify it incorrectly.
  243.  
  244.  
  245. Sorting:
  246.  
  247.   Records in the input file don't have to be in any particular order.  Unless
  248.   sorting is specified, the dates will be presented in the order they appear in
  249.   the file so putting them in chronological order makes the most sense.
  250.  
  251. Multiple input files:
  252.  
  253.   You can specify multiple date input files.  They are processed in the order
  254.   they are entered.  By default, each will have the initial date restriction
  255.   (typically 14 days).  You can override the date restriction for a specific
  256.   file by including the date restriction after the file name.  For example:
  257.  
  258.         DATES DATE1.TXT DATE2.TXT /D10 DATE3.TXT
  259.  
  260.   Given a default 14-day restriction, the date restrictions will be 14 days for
  261.   DATE1.TXT and DATE3.TXT, 10 days for DATE2.TXT.  If you want to override the
  262.   date restriction for all files, include that date restriction before the file
  263.   name.  For example:
  264.  
  265.         DATES /D5 DATE1.TXT DATE2.TXT /D10 DATE3.TXT
  266.  
  267.   In this case, the date restriction will be 5 days for DATE1.TXT and DATE3.TXT
  268.   and 10 days for DATE2.TXT.
  269.  
  270.  
  271. DATES.DOC                            6                         Revised: 11-30-96
  272.  
  273. Other event-by-event parameters:
  274.  
  275.   In addition to being able to specify "/Ddays" on an event-by-event basis,
  276.   certain command-line parameters can be embedded within the dates input file.
  277.   See the discussion about "Syntax" later for a description of these parameters.
  278.   These parameters must begin in the first column of the line and only one
  279.   parameter can be specified on a line.  These parameters override one or more
  280.   defaults for the current input file only and can be set and reset throughout
  281.   the file.  The parameters affect the defaults for all dates which appear after
  282.   them in the file until either another parameter overrides them or the file
  283.   ends.  The acceptable parameters are:
  284.  
  285.         /Ddays                   (can also be specified for an individual event)
  286.         /DATE=format
  287.         /DATE   and /-DATE
  288.         /DAY    and /-DAY        (same as /WEEKDAY and /-WEEKDAY)
  289.         /AGE    and /-AGE
  290.         /CTDOWN and /-CTDOWN
  291.         /COLOR=nnn nnn nnn nnn
  292.  
  293.   For example:
  294.  
  295.         01/01/XX A stellar new years event
  296.         /-AGE
  297.         /-DAY
  298.         01/20/92 Expect the unexpected!
  299.         01/22/94 Another one (still covered by same parameters)
  300.         /AGE
  301.         01/23/94 Skipping age on this one
  302.         /-AGE
  303.         01/25/94 And reinstating it here
  304.  
  305.   A sample United States-oriented DATES.TXT file is provided and consists of the
  306.   following lines:
  307.  
  308.        01/01/xx New Year's Day
  309.        01/3MO/xx Martin Luther King's birthday
  310.        02/14/xx \000\012\000 Valentine's Day 
  311.        03/17/xx St. Patrick's Day
  312.        03/30/xx -ish Easter
  313.        04/1SU/xx Daylight Savings Time begins (add an hour)
  314.        05/2SU/xx Mother's Day
  315.        05/LMO/xx Memorial Day
  316.        05/31/57 Bruce Guthrie (bguthrie@nmaa.org) \000\012\000√
  317.        06/3SU/xx Father's Day
  318.        07/04/xx July 4th (\000\012\000U.S \000\015\000Independence \000\009\000Day)
  319.        09/1MO/xx Labor Day
  320.        10/LSU/xx Daylight Savings Time ends (subtract an hour)
  321.        10/31/xx Halloween
  322.        11/1TU/xx Election Day
  323.        11/11/xx Veteran's Day
  324.        11/4TH/xx Thanksgiving
  325.        12/25/xx Christmas
  326.  
  327.   (See "Embedding decimal codes in the date files" discussion below for
  328.   explanation of "\nnn" codes.)
  329.  
  330.  
  331. DATES.DOC                            7                         Revised: 11-30-96
  332.  
  333. Embedding decimal codes in the date files:
  334.  
  335.   You can embed decimal codes in the data file using "\nnn" (where "nnn" is the
  336.   decimal value) or "&Hhh" (where "hh" is a hexadecimal code).  This is mainly
  337.   used in cases where you might want to split the entry into multiple lines by
  338.   putting in a "\013".  You're responsible for your own spacing if you use this
  339.   feature.  See the BRUCEHEX.DOC file.
  340.  
  341.   You can also use this feature to embed color commands within the text so the
  342.   text colors change when a particular item is displayed.  This requires some
  343.   effort but it can be done by embedding \000\0ff\00b in the text.  For example:
  344.  
  345.       07/06/95 This is a \000\006\003multiline\000\007\004\013test
  346.  
  347.   The example above displays the item in two lines.  The first part of the line
  348.   will be in the default color (defaults to white on black), the word
  349.   "multiline" will be brown on cyan, and the word "test" will be in white on
  350.   red.  The \nnn codes must be entered correctly or you'll get unpredictable
  351.   results.  Note that this requires three "\nnn" parameters each time; the
  352.   first is "\000" saying that the color's about to be reset, the second is
  353.   "\0ff" and specifies the foreground color, and the third is "\00b" and
  354.   specifies the background color.
  355.  
  356.   Foreground colors:
  357.  
  358.         Low intensity           High intensity
  359.  
  360.         0 = black                8 = dark grey
  361.         1 = blue                 9 = light blue
  362.         2 = green               10 = light green
  363.         3 = cyan                11 = light cyan
  364.         4 = red                 12 = light red
  365.         5 = magenta             13 = light magenta
  366.         6 = brown               14 = light yellow
  367.         7 = white               15 = bright white
  368.  
  369.   Adding 16 to any color will make the text blink.  Background colors can
  370.   consist of 0 to 7 above.  Bright white on blue, for example, would be
  371.   \000\015\001.
  372.  
  373.   If you wanted to, you could embed something like this in your file:
  374.  
  375.      07/04/xx July 4th \013\000\012\007▌▌\000\001\007░░\013\000\012\007▌▌▌▌
  376.  
  377.   The "▌" symbol is decimal 221 and can be entered as Alt-221 (using the numeric
  378.   keyboard or replaced with "\221").  Similarly, "░" is decimal 176.
  379.  
  380.   The above example would draw a (crappy) little flag on your screen.  Remember
  381.   again that you are responsible for your own line indentation for the second
  382.   and subsequent lines.
  383.  
  384.   Want to flag lines that are more significant than others?  Add something like
  385.   \000\012\000√ at the end of the items that are important.  This adds a bright
  386.   red on black check mark (decimal 251) to important lines.
  387.  
  388.  
  389. DATES.DOC                            8                         Revised: 11-30-96
  390.  
  391. Specifying command-line parameters:
  392.  
  393. Parameters for this program can be set in the following ways.  The last  setting
  394. encountered always wins:
  395.   - Read from an *.INI file (see BRUCEINI.DOC file),
  396.   - Through the use of an environmental variable (SET DATES=whatever), or
  397.   - From the command line (see "Syntax" below)
  398.  
  399.  
  400. Syntax:
  401.  
  402.     DATES [ date_file ... ] [ /Ddays ] [ /SKIP ] [ /DATE=format ]
  403.       [ /ODATE=format ] [ /-DATE ] [ /DAY ] [ /-AGE ] [ /FUTURE ] [ /CTDOWN ]
  404.       [ /SORT | /-SORT ] [ /GLOBAL | /-GLOBAL ]
  405.       [ /COLOR=nnn nnn nnn | /MONO ] [ /Q | /-Q ]
  406.       [ /CLS | /-CLS ] [ /P | /Pn | /-P ] [ /W | /W0 | /-W ] [ /R ]
  407.       [ /Iinitfile | /-I ] [ /? ] [ /?&H ] [ > filename ]
  408.  
  409. where:
  410.  
  411. "date_file" is the name of the input text file.  It can contain drive  and  path
  412. information if  desired.   This  defaults  to  DATES.TXT.   If  no  filename  is
  413. specified, the program will check for it along your DOS path beginning with your
  414. default subdirectory.  Multiple date files and date  restrictions  are  allowed.
  415. See the notes above about this.  In order to allow you to specify the  date_file
  416. (or files) in an *.INI file, the date_file name can be preceded  by  "/C".   For
  417. example, "/CC:\BAT\DATEMINE.TXT".
  418.  
  419. "/Ddays" (or "days") are the number of days in advance  you  want  the  warning.
  420. Initially defaults to /D14.  Generic days ("11/xx/xx") are not affected by  this
  421. setting; you automatically get the notice 15 days before the  beginning  of  the
  422. month and through the entire month itself.  Events coded with specific  "/Ddays"
  423. entries are also not affected by the command-line "/Ddays" setting.
  424.  
  425. "/SKIP" says to print a message (unless /Q is specified) but otherwise ignore it
  426. if one or more of the date input files is not found.
  427.  
  428. "/-SKIP" says to abort if any of the input files are not found.
  429.  
  430. "/DATE=format" specifies the format that the date is to  have.   The  date  must
  431. consist of pairs of "mm" (month), "dd" (day), and "yy" (year) characters in  any
  432. order.  A single consistent delimiter character--either "/", ".", or "-"--should
  433. be  used  around  the  pairs  of  characters.   Examples,   /DATE=mm/dd/yy   and
  434. /DATE=dd.mm.yy.   Note  that  the  format  does  not  restrict   you   to   have
  435. two-character date items; it is mainly used to identify  the  delimiter  between
  436. items as well as the order in which the  month,  day,  and  year  items  appear.
  437. Four-digit years, spelled out months, etc are all acceptable.
  438.  
  439. "/ODATE=format" specifies the format that the output date is to have.   See  the
  440. section on "How the dates are actually displayed" above for more  details  about
  441. options in the format.
  442.  
  443.  
  444. DATES.DOC                            9                         Revised: 11-30-96
  445.  
  446. "/DATE" indicates that the date is to be presented if the entry is show. This is
  447. initially the default.
  448.  
  449. "/-DATE" skips showing the date of the event when it's displayed.
  450.  
  451. "/DAY" (or "/WEEKDAY") shows the day of the week for each event if possible.
  452.  
  453. "/-DAY" (or "/-WEEKDAY") skips showing the day of the week.  This  is  initially
  454. the default.
  455.  
  456. "/AGE" shows the age of the event when it's displayed.  This is  only  done  for
  457. entries that have a specific year.  This is initially the default.
  458.  
  459. "/-AGE" skips showing the age of the event.
  460.  
  461. "/FUTURE" says to include dates which occur in future years outside of your date
  462. range.  For example, if it's currently June 5, 1996,  "/FUTURE"  will  allow  an
  463. event scheduled for June 5, 1997 to show up;  otherwise,  it  won't.   Initially
  464. defaults to "/-FUTURE".
  465.  
  466. "/-FUTURE" says that dates which occur in future years will not show  up.   This
  467. allows you to pre-load your file with major upcoming dates into the  far  future
  468. (family reunions for the rest of eternity, for example).  This is initially  the
  469. default.
  470.  
  471. "/CTDOWN" adds a "x days until" message in front of any displayed event.
  472.  
  473. "/-CTDOWN" skips adding the "x days  until"  message.   This  is  initially  the
  474. default.
  475.  
  476. "/SORT" sorts the entries by their date difference (the number of  days  between
  477. now and the date of the event).  If you're using more than one dates  file  with
  478. the "/-GLOBAL" (default) parameter, all appropriate entries from a  given  dates
  479. file will be sorted and displayed before any entries from the  next  dates  file
  480. are displayed.  The "/GLOBAL" parameter will combine  them  all  before  sorting
  481. them.  Using "/SORT" precludes you from  showing  any  display  comments  (lines
  482. beginning with "*")  in  your  file.   Currently,  the  program  limits  you  to
  483. displaying 100 items per input file if /SORT is specified; let me know  if  this
  484. limit is too low for you.
  485.  
  486. "/-SORT" says to display the entries as they're found in  the  files.   This  is
  487. initially the default.
  488.  
  489. "/GLOBAL" invokes "/SORT" and merges multiple date input files if found, sorting
  490. them as a unit instead of individually.
  491.  
  492. "/-GLOBAL" treats each date input file as a unique entity for sorting  purposes.
  493. This is initially the default.
  494.  
  495.  
  496. DATES.DOC                            10                        Revised: 11-30-96
  497.  
  498. "/COLOR=nnn nnn nnn" specifies the color settings to use for (in order)  regular
  499. text, dates happening today, and the ages of dates happening today.   Any  input
  500. lines which begin with an asterisk are printed using the third color set.   Each
  501. setting must consist of three digits, the first two being the  foreground  color
  502. and the last being the background color.  The foreground color should be  padded
  503. on the left with a 0 if it is only one digit in length.  Defaults to  "COLOR=070
  504. 150 090" (white on black, bright white on black, and bright blue on black).
  505.  
  506. Foreground colors:
  507.  
  508.         Low intensity           High intensity
  509.  
  510.         0 = black                8 = dark grey
  511.         1 = blue                 9 = light blue
  512.         2 = green               10 = light green
  513.         3 = cyan                11 = light cyan
  514.         4 = red                 12 = light red
  515.         5 = magenta             13 = light magenta
  516.         6 = brown               14 = light yellow
  517.         7 = white               15 = bright white
  518.  
  519. Adding 16 to any color will make the text blink.  Background colors can  consist
  520. of 0 to 7 above.  Bright white on blue, for example, would be "151".
  521.  
  522. "/MONO" (or "/-COLOR") suppresses all screen color settings.  Initially defaults
  523. to "/COLOR".
  524.  
  525. "/COLOR" (or "/-MONO")  allows  screen  color  settings  and  is  initially  the
  526. default.
  527.  
  528. "/Q" stops the printing every message except for the actual  date  lines.   This
  529. option is automatically invoked if redirection is used.
  530.  
  531. "/-Q" turns back on the printing of almost every message.  This is the initially
  532. default unless redirection is used.
  533.  
  534. "/CLS" clears the display before showing the results.
  535.  
  536. "/-CLS" does not clear the display first.  This is the default.
  537.  
  538. "/P" says to pause the output every 23 lines.  (NOTE:   The  /P,  /Pn,  and  /-P
  539. options affect pausing while listing events; the /W,  /W0,  /-W  options  affect
  540. pausing after the program finishes.)
  541.  
  542. "/Pn" says to pause the output every n-number of lines.
  543.  
  544. "/-P" says to not pause the output at all.  This is initially the default.
  545.  
  546.  
  547. DATES.DOC                            11                        Revised: 11-30-96
  548.  
  549. "/W" says to pause with a "Press any key to continue" message after the  program
  550. finishes if any hits were  found.   Note  that  this  parameter  is  ignored  if
  551. redirection out is being used.
  552.  
  553. "/W0" says to pause afterward whether any hits were found  or  not.   Note  that
  554. this parameter is ignored if redirection out is being used.  This  is  initially
  555. the default if the program is run under Windows.
  556.  
  557. "/-W" says to not pause afterward at all.  This is initially the default if  the
  558. program is run under DOS.
  559.  
  560. "/R" sets a DOS return code equal to the number of dates  found.   The  standard
  561. way to use something like this is with a  test  on  the  DOS  ERRORLEVEL  in  an
  562. AUTOEXEC.BAT file or something.  For example:
  563.  
  564.        DATES /R
  565.        IF ERRORLEVEL 1 GOTO HITS
  566.        GOTO END
  567.        :HITS
  568.        PAUSE
  569.        :END
  570.        ECHO DONE
  571.  
  572. Note that the results of particular example could have been  done  easier  using
  573. DATES' /W parameter.
  574.  
  575. "/Iinitfile" says to read an initialization file with the file name  "initfile".
  576. The file specification *must* contain a period.  Initfiles are described in  the
  577. BRUCEINI.DOC file.  Initially defaults to "/IDATES.INI".
  578.  
  579. "/-I" (or "/INULL") says to skip loading the initialization file.
  580.  
  581. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  582.  
  583. "/?&H" gives you a hexadecimal and decimal conversion table.
  584.  
  585. "> filename" redirects  the  output  to  a  DOS  file.   This  is  standard  DOS
  586. redirection.  Automatically invokes /Q option and turns  off  the  last  of  the
  587. status messages.
  588.  
  589.  
  590.  
  591. DATES.DOC                            12                        Revised: 11-30-96
  592.  
  593. Return codes:
  594.  
  595. DATES returns the following ERRORLEVEL codes:
  596.       255 = syntax problems, or /? requested
  597.  
  598. If /R is specified, the ERRORLEVEL code will be the number of hits found.
  599.  
  600.  
  601. Author:
  602.  
  603. This program was written by Bruce Guthrie of Wayne Software.  It is free for use
  604. and redistribution provided relevant documentation is kept with the program,  no
  605. changes are made to the program or documentation, and it  is  not  bundled  with
  606. commercial programs or charged for separately.  People who need to bundle it  in
  607. for-sale packages must pay a $50 registration fee to  "Wayne  Software"  at  the
  608. following address.
  609.  
  610. Additional information about this and other Wayne Software programs can be found
  611. in the file BRUCE.DOC which should be included in the original  ZIP  file.   The
  612. recent change history for this  and  the  other  programs  is  provided  in  the
  613. HISTORY.ymm file which should be in the same ZIP file where "y" is  replaced  by
  614. the last digit of the year and "mm" is the  two  digit  month  of  the  release;
  615. HISTORY.611 came out in November 1996.  This same naming convention is  used  in
  616. naming the ZIP file (DATESymm.ZIP) that this program was included in.
  617.  
  618. Comments and suggestions can also be sent to:
  619.  
  620.                 Bruce Guthrie
  621.                 Wayne Software
  622.                 113 Sheffield St.
  623.                 Silver Spring, MD 20910
  624.  
  625.                 fax: (301) 588-8986
  626.                 e-mail: bguthrie@nmaa.org
  627.                 http://hjs.geol.uib.no/guthrie/
  628.  
  629. Please provide an Internet e-mail address on all correspondence.
  630.  
  631. 
  632.